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PREFACE 



This technical report provides dociimentation of the Plot System 
for use on the IBM 1500 Instructional System. It is comprised of 
four parts: 

Plot System User's Guide in which the usage and application 
rules for the Plot System are discussed from a user's 
standpoint . 

Systems Programmer's Ouide which contains system logic, 
organization, and installatior procedures for use by the 
systems programmer. 

Tutorial for use with the plot system demonstration 
program, "plot/' 

Coursewriter II listing of the plot system demonstration 
program. 



These Coursewriter II Functions were developed through funds provided 
by the Advanced Research Projects Agency of the Department of Defense and 
monitored by the Office of Naval Research under Contract No. N00014-67-A0126 , 
and by National Science Foundation Grant GJ 509 X- The system analysis and 
programming was done by Mr. Matthew Wheaton of Booz-Allen Applied Research, 
Incorporated. 
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I. PLOT SYSTEM USER'S GUIDE 

f 

The IBM 1500 Instructional System has the capability of rapidly 
presenting character oriented material on the 1610 display unit. This 
capability has now been augmented to include the ability to graph 
mathematical functions or other data on the 1510 terminal. A series 
of six functions and a station command have been designed to enable 
Coursewriter II authors to use this plotting capability in presenting 
course material. 

The plot system uses an area of the display which is 30 columns 
by 30 rows. This area is in the upper right portion of the display. The 
leftmost ten columns and the Dottom two rows are thus left for author 
use in displaying explanatory or descriptive material. Thirty rows by 
30 columns i.e. , 240 X 180 points are used for tht? plot area since there 
are 8 points per column and 6 points per row. Each noint may be indi- 
vidually addressed to allow the author complete control over the display. 

1. UMIT VALUES 

Before specifying any point to be turned on, the author must set 
the limit values in both the X and the Y directions. Function SET has 
been provided to do this in coordination with function FCALC. The 



X limit values describe the values of the leftmost and rightmost points 



on the horizontal scale and the Y limit values describe the values of 
the bottommost and topmost points of the vertical scale. 



All values are floating point. Hence, any numerical expression 
acceptable to function FCALC is valid. Two parameter values are pro- 
vided for function FCALC to use in conjunction with the plot system. 
They are: 



fn fcalc/5 where numeric evaluation is made of the 
contents of buffer 0. A result is returned in display 
code to buffer 0. In addition, the resulting value. 
In floating point format, is placed in counters 29 and 
30. A request to raise a negative base to a non-zero 
power will be treated as if the parameter were 0. 

fn fcalc/6 where numeric evaluation is made of the 
contents of buffer 0. A result is returned in display 
code to buffer 0. In addition, the resulting value, 
in floating point format, is placed in counters 29 and 
30. A request to raise a negative base to a non- 
zer.-^ powei will be treated as if the parameter were 1. 



Function SET uses tl-e contents of counters 29 and 30 to 
store limit values for the X or Y scales depending on the parameter 
of the call. Function SET action is as follows: 

• fn set/xs stores the contents of counters 29 and 
30 as the leftmost coordinate for the display of the 
active station. 



fn set/xe stores the contents of counters 29 and 30 
as the rightmost X coord inat»j for the display of the 
active station. 

fn set/ys stores the contents of counters 29 and 30 
as the bottommost Y coordinate for the display of the 
active station. 

fn set/ye stores the contents of counters 29 and 30 
as the topmost Y coordinate for the display of the 
active station. 

If any other parameter is used, function SET will 
return error code P5. 



The following set of instructions will describe the plot area such 
that all points with X coordinate greater than or equal to -100 and less 
than or equal to 100 and with Y coordinate greater than or equal to 20 
and less than or equal to 50 will lie within the graph. 



Id 


-100/bO 


Id 


20/bO 


fn 


f ca Ic/ 5 


fn 


fcalc/5 


fn 


set/xs 


fn 


set/ys 


Id 


100/bO 


Id 


50/bO 


fn 


f ca Ic/ 5 


fn 


fcalc/5 


fn 


set/xe 


fn 


set/ ye 



2. AXIS PIACEMENT 

After the limit values are set, the placement of the coordinate axes 
may be set. Function AXIS .3 prepared for this purpose. Its action is 
as follows: 

fn axis/d sets a flag so that no coordinate axes are 
displayed at the active station when function PLOT 
is used. 
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fn axis (null parameter, or any other than d) uses the 
contents of counters 27 and 28 as the floating point 
value of the X coordinate of the axes intersection, and 
the contents of counters 29 and 30 as the floating point 
value of the Y coordinate of the axes intersection for 
the active station. Whenever function PLOT is used, 
horizontal and vertical axes will be generated which 
intersect at the indicated point. 



If the axis limits have not been set, or set improperly, such as 
both limits at the same value, function a>:is will not set any axis 
pointers but will store an error cole in counter 23. These codes are 
the same as described in 'he documentation of function FCALC. The 
contents of counter 22 will be meaningless after an error. 

If the limits had been set as described above, the following 
instructions would cause the axes to intersect at the center of the 
plot area . 



Id c30/c28 

3. POINT ADDITION 

Once the limit values have been set, it is possible to turn on 
any point in the plot display area by describing its coordinate values. 
Function ADDPNT is prepared to store points for the active terminal. 
Function ADDPNT has no paran^eter. When it is called, the contents 



Id 
fn 
Id 



0/bO 

fcalc/5 

c29/c27 



Id 
fn 
fn 



(20+50)/2/b0 

fcalc/5 

axis 
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of counters 27 and 28 are used as the floating point value of the X 
coordinate of the point and the contents of counters 29 and 30 are 
used as the floating point value of the Y coordinate of the point. As 
in function AXIS, an arithmetic error will result in no point stored for 
the active terminal, an error code stored in counter 23, and the contents 
of counter 22 destroyed. 

mthe limits had been set as described above, the following 
instructions will turn on the points at the four corners of the display. 



If at any time the space for the active terminal is depleted, i.e. , 
over 959 points are stored, function A DDPNT returns message code PI . 
If no disk space is available for any terminal, the function returns mes- 
sage code P2 . 

4. PLOT DISPLAY 

When one or more points have been set for the active terminal 
by use of ADDPNT, the plot may be displayed. This is done by using 



Id 
fn 
Id 
Id 
Id 
fn 
fn 
Id 
fn 
fn 



-100/bO 

fcalc/5 

c29/c27 

c30/c28 

20/bO 

fcalc/5 

addpnt 

50/bO 

fcalc/5 

addpnt 



Id 
fn 
Id 
Id 
Id 
fn 
fn 
Id 
fn 
fn 



100/bO 

fcalc/5 

c29/c27 

c30/c28 

20/bO 

fcalc/5 

addpnt 

50/bO 

fcalc/5 

addpnt 



ERIC 



1-5 



function PLOT. This function, which has no parameters, creates 
a display of the points which have be .n set by ADDPNT and the axes 
which have been set by AXIS, No error messages are generated by 
PLOT. However, if there are no points to be displayed, function PLOT 
returns with no action taken. 

5. POINT DELETION 

When an author begins to build a display, and when one is no 
longer needed for the active station, function DELETE should be used. 
This function, which has no parameter, deletes all the stored points 
for the active terminal and restores disk space for use by other terminals 
or for re-use by the active terminal. No error messages are generated 
by function DELETE. 

6. STATION COMMAND PL 

Plots may be built up dynamicall/ using Coursewriter II instructions 
as has been described above. In addition to this, an author may build 
a display at his terminal, name it, and recall it by name at 1 or more 
s+udent terminals. The station command PL has been provided to assist 
the author in doing this. To use it, the author first builds a plot as 
desired at his terminal using the above described functions. The he gets 
system attention and types pi a,xxxxxx, where xxxxxx is a 1 to 6 charac- 
ter name. The station command will store the active terminaTs plot under 



the given name, delete it from the active terminal, and return the 
message '•command completed.'* 

If a named plot is no longer needed, an author may get attention, 
and type pi d,xxxxxx where xxxxxx is the name of a stored plot. The 
station command will delete the plot, add its space to the free area, 
and return the message "command completed/' 

An author may view the names of the stored plots by getting 
attention, and typing pi 1. The command will return a list of all plots 
stored by name. 

7. PLOT TRANSFER 

A named plot may be retrieved at any station by use of the function 
TRNSFR. This function, which has no parameter, uses the first 6 charac- 
ters of buffer 0 as the name to search for in the table of stored plots. 
When the plot is found, a copy is made in the storage area for the active 
terminal, and any plot there is released as free space for use by any 
terminal. The following instructions would bring a plot named "abcdef" 
into the active terminal's storage area. 

Id abcdef/bO fn trnsfr 

If the above named plot were not in the table of saved plots, the 
function would return error code P3 . If there is no room available in 
which to store the plot, the function returns error code P4 . 
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II. SYSTEM PROGRAMMER'S GUIDE 
PLOT DIRECTORY AND POINT STORAGE 



Four disk sectors are required to keep a directory of plot activity. 
They may be on any logical pack. The pack number must be i ndicated 
as LOGPK when assembling the six functions and the station command. 
In addition, the first sector of the directory must be indicated as 
DRTRY in the assemblies. 



(1) Sector 1 Layout 

Words/0 - /F contain, by terminal, the number 
of data points stored. 

Words /20 - /3F contain, by terminal, the sector 
number of the first sector of stored data points. 

Words /40 - /5F contain, by terminal, the sector 
number of the second sector of stored data points. 

Words /60 /7F contain, by terminal, the sector 
number of the third sector of stored data points. 

Word /80 is always zero. 

Words /81 - /DF contain a list of sectors which 
are available to store data points. This is known as 
the free table. 

Word /EO contains the address within the sector 
of the last entry in the free table. 
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Words /1 00 - /I IF contain a value which is the 
number of points from the left of the plot area where 
the Y axis will be located. 

Vv^'ords /120 - /13F contain a value which is the 
number of points from the top of the plot area where 
the X axis will be located. If the value is /FY , 
no axis will be displayed. 

(2) Sector 2 Layout 



Words /O - /3F contain, by terminal, two word 
entries in floating point format indicating the 
leftmost limit of the plot. 

Words /4 0 - /7F con'rain, by terminal, two word 
entries in floating point format indicating the 
rightmost limit of the plot. 

Words /80 - /BF cont^iin, by terminal, two word 
entries in floating point format indicating the 
bottommost limit of the plot. 

Words /CO - /FF contain, by terminal, tv^o word 
entries in floating point format indicating the 
topmost limit of the plot. 



(3) Sectors 3 and 4 Layout 



Sectors 3 and 4 of the directory contain the table of named 
plots. They are brok.en into eighty groups! of eight words each. 
Each of these eight word groups is either entirely zero or: 



Words /O - /2 contain 6 EBCDIC characters compris- 
ing the name^ left adjusted blank filled. 

Words /3 - /5 contain the addresses of the sectors 
which hold the plot data . 
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Word /5 contains the count of data poiints stored 
for the plot. 

Word /7 contains the coordinate points for the 
axes intersection. The loft byte contains the 
number of points from the top of the plot area 
where t?ie X axis will be displayed. If /FF is 
found there, no axes will be displayed. The 
right byte contains the number of points from the 
left of the plot area where the Y axis will be 
displayed . 



(4) Point Storage 

All other sectors, which must first be in the free table, 
contain data points for terminals or for named plots in the 
save table* Each word is in the following format: 



The left byte contains the number of points from 
the top of the display area where the point will 
be displayed. 

The right byte contains the number of points from 
the left of the display area where the point will 
be displayed. 

The last word of a set of data points contains 
/FFFF as a flag. 



2. SYSTEM INSTALLATION 



An area of from 16 to 96 sectors (1 to 5 blocks) should be reserved 
on a single disk pack. This is best done by registering courses and then 
changing the first character of the course name in the directory to a blank. 
This will leave the area available for data points and prevent inadvertant 
deletion of the area . 
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Four contiguous sectors of this area should then be used as the 
directory. To prepare them., the system programmer should iniMre the t 
all four sectors are filled with zeros. Then, starting with word /SI 
of the first sector, he should put in the addresses of all sectors which 
are available for point storacie. This should include all sectors which 
have been reserved except the four to be used as the directory. Lastly, 
word /EO should be set to contain the address of the word with the last 
sector entry in the free table. 

After setting up the directory, the six functions and the station 
command should be assembled. The EQUs referenced by the names LOGPK, 
DRTRY, and FLSEK should be set respectively to the value of the directory 
logical pack, the directory first sector address and the sector address 
where the absolute overlay of FCALC is loaded. 

The functions should then be loaded and the station command 
put on the system pack according to standard procedures. The station 
command monitor should be p<?.tched to include the letters "'PL"" and 
the sector address of the station command. 

3. MODIFICATION NOTES 

Functions AXIS and ADDPNT interface with the overlay portion of 
function FCALC. It is imperative that appropriate modification be made 
to the EQUs in these functions if FCALC is changed. 
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Version two of FCALC must be used so that parameters 5 and 6 
return a value to counters 29 and 30, 

If only object decks are available for installation, install 
them as directed above and then (1) store the logical pack number in 
word /2B of Plot, word /71 of TRNSFR, word /28 of DELETE, word /61 
of AXIS, word /2 of SET, and words /3 and /D3 of ADDPNT; (2) store 
the address of the first sector of the directory in word /4B of PLOT, 
word /70 of TRNSFR, word /3 of DELETE, word /4E of AXIS, word /8 
of SET and word /5 of ADDPNT; (3) store the address of the third 
sector of the directory in word /73 of TRNSFR; (4) store the address of 
the FCALC overlay in word /63 of AXIS and word /E3 of ADDPNT; and 
(5) patch the station command by setting word /7230 to the logical 
pack number, word /Till to the first sector of the directory and 
word /722F to the third sector of the directory. 
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TUTORIAL FOR USE WITH THE PLOT DEMONSTRATION PROGRAIvi "PLOT" 
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The purpose of this document is to familiarize authors with a set of 
plot functions available for use with Coursewriter II. To understand the 
use of the six graph functions and one station command which are used in 
connection with the definition and utilization of graphical infoririation , the 
following should be kept in mind. First, there are three aspects of a 
graph whic^ can be manipulated indapendently of one another: (1) the scale 
of the X and y dimensions, (2) the origin of the axis with respect to the 
scale, and (3) the coordinates of a point with respect to the scale. 

In the second place, information defining a graph can be thought of as 
residing in two places^ One of these is in a buffer assigned to a given 
terminal; the other is in a buffer referred to as the graph library. Entries 
in the graph library can only be changed by the station command. Information 
can be read from tbC; library or manipulated in the terminal buffer with the 
six graph functions. 

The ''plot" demonstration program provides a convenient way to work with 
graphical information as an author at the terminal. The program incorporates 
some of the logic which an author will have to explicitly provide in courses 
developed by him. It is suggested that this document be used while signed 
on to the demonstration program "plot". One possible sequence through this 
program is given in Table 1.1 with corresponding references to relevant 
pages in the documentation. To follow this sequence, perform the action (s) 
listed in the first column and then refer to the corresponding section of 
the document given in the second column. 
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Table 1.1 Suggested Sequence through Plot Demonstration Program 



1 

1 • 


1 u oiuli Uli . 








\G0 TO NEXT ACTION) 


2 








ON THT^ rnilR<;F RFFORF' 






CA p 1 u ta / c 


section 2.0 




\j 1 i it.r\yv lot.* 






ex Dint °/ e 




3. 


TO EXECUTE FN SET ENTFR- 






s 


section o.u 


4. 


ENTER AS REQUESTED- 






0 for X axi^^ c;tArt \y;)1ijp 






TOO "Fny* y ;^ytc onH 

1 ui A OA 1 b ciiu VolUc 






u lUf Jr dA 1 b Start Vo 1 Uc 






1 uu Tor y a A 1 s enu Vd I ue 


(GO TO NEXT ACTION) 


'J • 


TO pyFrilTF FN AYT<: CMTCD- 






a 


section 5.0 


6. 


ENTER AS RFOUIRFD" 






no for "Do you wish to delete axis?" 






0 for x coordinate of y axis 






0 for y coordinate of x axis 


section 6.0 


7. 


TO EXECUTE FN ADDPNT, ENTER: 






m 


section 7.0 



(Note: an alternate coded slash is indicated by this symbol: °/) 
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8. 


ENTER AS REQUIRED: 








0 foY X coordinate value 








0 for y coordinate value 


section 


8.0 


9. 


TO EXECUTE FN AXIS, ENTER: 








a 


section 


9.0 


i 10. 


TO EXECUTE FN AXIS, ENTER: 






i 


a 

no for ''Do you wish to delete axis?" 






1 


200 for X coordinate of y axis 






1 
1 
1 

j 


200 for y coordinate of x axis 


section 


10.0 


I 11 . 

1 

( 
I 


TO EXECUTE FN SET, ENTER: 






1 
1 

i 


s 

n for X axis start value 






i 


400 for X axis end value 






j 


0 for y ax"S start value 






i 

! 


400 for y axis end value 


section 


11 .0 


12. 


TO EXECUTE FN ADDPNT, ENJER: 








m 


section 


12*0 


' 13. 


TO EXECUTE FN DELETE, ENTER: 






j 


d 


section 


13.0 


14. 


TO EXECUTE FN TRANSFER, ENTER: 






i 
1 


t 








TuriTun Tor tnter piot narne 


sec LI on 




15. 


TO EXECUTE FN TRANSFER, ENTER: 








t 






! 


funfun for "Enter plot name" 


section 


15.0 
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16. TO EXECUTE pi 1, ENTER: 






[ATTENTION] 






qu 






[ATTENTION] 






pi 1 


section 


16.0 


17. TO EXECUTE pi a V graph name 






AND LIST GRAPH LIBRARY, ENTER: 






[ATTENTION] 






qu 






[ATTENTION] 






nl a °/ mv own 






[ATTENTION] 






pi 1 


section 


17.0 


18. TO EXECUTE pi d °/ nraoh name 






AND LIST GRAPH LIBRARY, ENTER: 






[ATTENTION] 






pi d °/ my own 






[ATTENTION] 






pi 1 


section 


18.0 
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This program has two basic purposes: 

(1) provide a demonstration of the six plot functions 

(2) provide an environment for an author to define graphs for 
the graph library which may be referred to in CAI courses. 



The capabilities of the plot functions will be illustrated first. 
Compare Figure 2.1 with the screen display. Information for the plot area 
can be manipulated using: 

(1) fn set (set scale for x and y dimensions) 

(2) fn axis (define origin for axis) 

(3) fn addpnt (add a point to the graph) 

(4) fn plot (plot graph using information stored about scale, axis 

and points) 

(5) fn delete (delete graph) 

(6) fn trnsfr (transfer predefined graph from graph library to 

terminal buffer) 



GO TO ACTION 3, TABLE 1,1 



00 00 
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This function provides a definition of the scale assigned to the x and 
y dimensions of the graph displayed in the plot area. The format of this 
function is: 



fxs 

fn set "/.xe f 

ys 
(ye 

where 

xs = set X dimension £tart of scale 
xe = set X dimension ^nd of scale 
ys = set dimension s_tart of scale 
ye = set dimension end of scale 

Prior to the execution of the set function, counters 29 and 30 must be 
loaded with the desired scale value in floating point form. This can be done 
by loading the numerica"^ value (or numerical expression) into bO and then 
executing: 

fn fcalc V 5 ?4 

The floating point version of the v^lue in bO will be returned in c29 
and c30. An example of the use of fn set in the demo program is given in 
Figure 3.1. Note that the demo program requires you to enter only the actual 
numerical value or numerical expression for the x and y dimensions. 

60 TO ACTION 4, TABLE 1.1 



p.8/27 
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SETAX'SE 

1 PR . . 

2 01^ 0 + /32*E 

^ HT .0+/?.+/40.0-t-/(G )I VF X AXI^ .START \ /AIHF.::=P 

4 « 0+/2t+/40. 0+/+/99+/*E 
(8+/ ) AA*E . ^ 

6 LD 0+/C23*E 
7_m ELALC + /5»E 

8 BR SETAX + /C23+ /C. + /0*E 

q FN '^FT + /XS*F 

SETXE*E 

1 DT «0+/2»+/40»0 + /(G)IVE X AXIS END^ALUE^E 

2 LD 0+/C23*E 
3_._£P . 0+/?. +/4 0.0 + /+/99+/*F 



4 AA (8-t./)AA*E 

5 FN FCALC + /5*E 

6 BR SbTXE+/C23+/G+/0*E 



7 FN SET+^XE*E 
SFTY5;*F 



1 DT tO+/2t+/40.0+/(G)IVE (Y )AXIS START VALUE -E 

2 LP 0+/r.?3*E 



3 EP t 0+/2t+/40tO+/+/99+/*E 

4 AA (8+/)AA*E 



5 FN FCALC+/5*E 

6 BR SbTYS+/G23+/G+/0*E 



7 FN SET+/YS*E 
SETYE*E 



1 DT tO+/2t+/40tO+/(G)IVE (Y )AXIS END VALUE*E 

2 LD 0+/C23*E 

3 EP t 0+/2t+/40tO+/+/99+/*E 

4 AA (8+/)AA*E 

5 FN FCALC+/5*E 

6 RR S£TYF+/r.?^+/G + /0*F 



7 FN SET+/YE*E 
R RR PI nT*F 



FIGURE 3.1 - Use of fn set and associated logic in the "plot" 
demonstration program 



ERIC 
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5,0 The "Define Axis" Function 

The effect of this function is to define the origin of the axis or 
to delete the axis. The origin may be any value within the coordinate 
scales established by the set function. The function format is: 
fn axis ^/ d 

where: 

d= delete current axis (not used when defining axis) 
Prior to the execution of the function, countera 7J and 28 must be 
loaded with the x coordinate of the y axis in floating point form. 
Likewise, counters 29 and 30 must be loaded with the y coordinate of the 
X axis in floating point form. The author would use: 

fn fcalc V 5 ?i 
in this connection as described in section 3.0, 

An example of the use of fn axis in the demo program is given in 
Figure 5,1 , 

GO TO ACTION 6, TABLE 1,1 



AxiS=:<E 



1 


PR 


*t 




Ut 


0+/32*E 


3 


DT 


,0+/2.+/40,0+/(D)0 YOU WISH TO DELETE AXES(/=i=E 




EP 


.0+/2.+/40,0+/+/3+/*E 


5 


CA 


YES+/CC*E 


6 


FN 


AX IS+/D*E 


7 


BR 


PLQT=:=E 


8 


AA 


(8+/ ) AA*E 


AX I SX: 






1 


DT 


,0 + /2.+/40,0+/( E)NTER (X )COORDINATE OF (Y )AXIS.=:=E 


2 


LD 


0+/C23*E 


3 


EP 


»0+/2»+/40»0+/+/99+/*E 


4 


AA 


(8+/) AA*E 


5 


FN 


FCALC+/5*E 


6 


BR 


AXI SX+/C23+/G+/0*E 



7 LD C30+/C28*E 

8_UD C294>/C27ritE 

AXI SY*E 

■ 1 RT tn+/2»+/40>n+/f F)MTEff (Y )COQRDI.MATE OF (X )AXIS, ^^E 

2 LD 0+/C23*E 

4 AA (8+/)AA*E 

„„ 5 FN Pr Ai r + z^^icP ^ 

6 BR AX I SY + /C23+/G+/0*E 
7 FN &XT S>»F 

8 BR PLQT*E 



FIGURE 5.1 - Use of fn axis and associated logic in the "plot" 
demonstration program 



6.0 
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Every time the screen shows the current display, the demo program calls 
fn plot. Note, however, that the plot area is blank even though 

we have established a scale and defined an axis. This illustrates the re- 
quirement that A I LEAST ONE POINT MUST BE DEFINED BEFORE ANY PORTION OF A 
GRAPH IS DISPLAYED. If it is desired to display an axis only, a point could 
be defined on the axis and thus it would be overlayed by the axis line. 



GO TO ACTION 7, TABLE 1.1 



7,0 The "Add Point" Function 



This function stores information defining a point for use by the plot 
function at a later time. The format is: 

fn addpnt t 

Prior to the execution of this function counters 27 and 28 must be 
loaded with the x coordinate of the point in floating point form. Likewise 
counters 29 and 30 must be loaded with the y coordinate of the point in 
floating point form. The author would use: 

fn fcalc V 5 j« 
in this connection as described in section 3.0. 

An example of the use of fn addpnt in the demo program is given in 
Figure 7.1 



GO TO ACTION 8, TABLE 1.1 



PO INT *E 




1 
-I- 


PR 




c 


L/ l_ 


no. / 9 :{cP 




DT 


na./'p a./An rii_//ci\MTCD nn d n t Ni A x c v/ a i i i c c 
• U + //'«'r/*+U«Ul"/lrJI\!lrK IX llJMJKtJINAI h VAI IJr-rf- 








5 


LD 


n_l_ / f OO^IrC 


6 


LD 


04- / r 9 P 


7 


FN 


F(:alc+/5*e 


8 


BR 


P0INT+/C23+/G+/O*E 


9 


LD 




10 


LD 


C29 + /C27*i: 


P0liNiT2 


*f: 




1 


PR 




2 


LD 


0+/C22*E 


3 


LD 


0+/C23*E 




DT 


»0 + /2»+/40»0+/(G)IVE (Y )COORDINATE VALUE^^^E 


5 


EP 


»0+/2»+/40»0+/+/99+/*E 


6 


FN 


Fl ALC + /5*E 


7 


3R 


PGINT2+/C23+/G+/0*E 


8 


FN 


ADDPNT*E 


9 


BR 


PLOT*E 



FIGURE 7.1 - Use of fn addpnt and associated logic in the "plot" 
demonstration program 



p. 14/27 
n-21-59 



8.0 



Recall that the dpmo program calls fn plot whenever it returns to this 
place in the program. Note that the axis is now displayed. (The point 
defined at (0,0) has been overlayed by the axes.) 

The next sequence of actions will demonstrate that the definition of 
the axes is indepe/idant of the points plotted. 



GO TO ACTION 9, TABLE 1 .1 



ERIC 
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9.0 

Recall that the plot scale is still 0-100 for both the x and y 
dimensions. Using the demo program, enter several new values for the origin 
of the axes and note the effect. (Remember to enter "a" for axis when 
the "what next" statement appears in the lower right hand corner of the 
screen.) 

When you have satisfied your curiosity about this feature, return 
to the place in the program where the graph is plotted and then: 



GO TO ACTION 10, TABLE 1.1 



10.0 



In this case the origin of the axis is defined outside the scale 
limits originally established. Note the appearance of the axis origin 
at (100,100). Definition of an origin outside the scale limits will 
cause the axis to appear at^ those limits. 

A change in scale using fn set will be made next. 



60 TO ACTION 11, TABLE 1.1 
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11.0 



Note that the change of scale did not alter the axis position. To 
define the origin at (200,200) with respect to the new scale established 
by fn set requires redefinition of the origin. 

Perhaps you would like to try other combinations of fn set and fn 
axis. As you do, notice that numerical expressions such as 10+10, 
5x2, etc.^ can be used. The reason for th.ia is that fn fcalc is used to 
get the data into the proper format. When you finish, return the scale 
values to: 

0 for X and y axis start value 
100 for X and y axis end value 
and return the axis origin to (0,0). 



SO TO ACTION 12, TABLE IJ 



12.0 



Enter both numerical values and numerical expressions for the x and 
y coordinates for several points. You may also wish to move the axis 
about, demonstrating the independence of the plotted points and the axis. 
Define a point outside the scale range to see what happens. 



GO TO ACTION 13, TABLE 1.1 



13.0 
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Note that the plot area on the screen is blank. This resulted from 
using the delete function where the format is: 

fn delete f 

The basic capability has been demonstrated for five of the six plot 
functions: fn set, fn axis, fn plot, fn addpnt, and fn delete. The next 
phase of the explanation describes the transfer function (fn transfer) 
and illustrates the use of the "plot" demo program to define an entry in 
the graph library. 

The description at this point is functional rather than specific. 
Documentation will be available at a later date for those who want to know 
the details of how the system handles information about the graph. 

Imagine there exists for each terminal a graph buffer as shown in 
Figure 13.1. As indicated in the Figure, fn plot uses the information in 
this buffer to provide a graph on the screen. The information was put 
into the buffer by three of the functions you have used so ^z^ . (The delete 
function, obviously, deletes the information in this buffer.) 

But there is another possible source of information for the terminal 
graph buffer other than the three functions mentioned above. A predefined 
graph in the graph library (we will consider how it was defined later), and 
the transfer function are involved here. 

As shown in Figure 13.2, a copy of a graph in the graph library may 
be transferred to the graph buffer at the terminal used by a given student. 
The graph in the terminal buffer can then be updated through the plot 
functions based on the way the student progresses through the course. The 
original graph in the graph library remains unchanged as do the copies of 
the graph which might be in other terminal buffers. 



p. 20/27 
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Thus the transfer function: 

fn trnsfr °l -cgraph name> f 
is used to move the information from the graph library into the terminal 
graph buffer. For a demonstration of the use of the transfer function, 
assume that a graph named funfun exists in the graph library. 



60 TO ACTION 14, TABLE I il 



ERIC 
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14.0 
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Information about the graph funfun was transferred to your terminal's 
graph buffer. Enter additional points in the same way you did earlier 
and then: 

GO TO ACTION 15, TABLE 1 .1 
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15.0 



Notice that the original graph, funfun, has overlayed the information 
in your terminal buffer. 

Now we will discuss how to define a graph in the graph library (i.e., 
transfer information f'"om the terminal buffer to the graph library). A 
station command, pi, is used in this situation. The format of this command 
is: 



pl 



d °/ <graph name> 
1 



where; 

a is the add option for entering <graph name> into the library 
d is the delete option for deleting <graph name> from the library 
1 (as the only parameter) yields a Ijsting of the graph in the 
library 

The pl command can be used in the author mode only. 



(Note: DO NOT DELETE funfun) 



GO TO ACTION 16, TABLE 1.1 
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16.0 

Note the graphs in the library (including funfun). Now create a 
graph in your terminal buffer. Recall that this involves setting thp x 
and y scale values, defining the axis origin, and defining coordinates for 
the desired points (refer to Table 1.1 if necessary). The name of your 
graph can be from 1 to 6 characters in length and include any of the 
characters (except the "enter" character) in the system dictionary. 
Call your graph "my own", and 

60 TO ACTION 17, TABLE 1 .1 
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17.0 

Your own "my own" is in the graph library. Any author can now use 
fn trnsfr ° I my own 
to bring that graph into the student's terminal buffer. 



GO TO ACTION 18, TABLE 1.1 



p. 21/21 
11-21-69 



18.0 



Now the graph "my own" is no longer available in the library. 
You may wish to try oat various combinations of the features to which 
you have been introduced. One word of caution: PLEASE DO NOT DELETE ANY 
GRAPHS FROM THE LIBRARY OTHER THAN THOSE YOU CREATE- 

It is hoped that extended features can be added to the demo program 
periodically. If you havis any comments or suggestions for improvement 
related to the graph functions, the demo program, or this documentation, 
please make these on the attached blank sheets. Include your name if 
you would like to discuss these comments in more detail. 



APPENDIX B 
LISTING OF DEMONSTRATION PROGRAM "PLOT" 
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**PLOT 00 ' 00202 

PLOT»E . , 





1 




*E 








2 


OE 


o+/32*E 








3 


DT 


0,0+/StO+/40*0+/<T)HlS AREA*E 






. .. 


4 


OT 


.O+/2.+/40.O+/1S SAVED*E 








5 


DT 


»0+/2. +/40,0+/FOR THE*E 








6 


DT 


. 0+/2.+/40, 0+/AUTHOR*E 






_ 


7 

8 


DT 
DT 


»O+/2.+/40.0+/T0 USE*E 
t 0+/2. +/40. 0 + /FOR*E 








9 


DT 


.0+/2. +/4 0.0+/E XPLAN-*E 








10 


DT 


.0+/2.+/40. 0+/ATORY*E 








11 


DT 


.0+/2.+/4 0.0+/MATERIAL.*E 








12 


DT 


t 0+/2.+/40. 0 + / *E 








13 


DT 


»0+/2.+/40.0+/ *E 








14 


OT 


t 0+/2.+/40. 0 + / *E 








15 


DT 


.e+/2.+/40.0+/ *E 








16 


OT 










17 


DT 


. G+/2. +/4 0«0+/— *E 








16 


OT 










19 


FM 


PLOT*E 









Eh*E 












1 


OT 


3 0,25+/2. 30+/lO,25+/(W)HAT NEXT( /*E 








2 


EPI 


3O,36+/2.30+/l,36+/+/l+/*e 








3 


CA 


S+/CC«E 










BR 


SETAx*E 








5 


CA 


A+/CC*E- 








6 


BR 


AX IS'i'E 








7 


CA 


T+/CC*E 






'■ 


8 


BR 


TRNSF#E 








9 


CA 


0+/CC*E 








10 


pR 


• 

DELFTF*F 








11 


CA 


P+/CC*£ 








12 


BR 


PLOT*E 








13 


CA 


M+/CC*E 









14 


BR 


POINT*E 








15 


AA 


(8+/)AA*£ 








16 


BR 


EH«E 








SETAx*E 










1 


PR 


*E 








2 


DE 


0+/32*E 








3 


DT 


.0+/2.+/40»0+/(G)IVE X AXIS START VALUE. «E 








4 


EP 


*0+/2» +/4 0»0+/ + /99 + /*E 






:, 


5 


AA 


(8+/ ) AA*E 








6 


to 


0+/C2 3*£ 








7 


FN 


FCALC+/5*E 








6 


BR 


SETAX+/C23+/G+/0*E 








9 


FN 


SET+/XS*E 








SETXE*E 










1 


DT 


. 0+/2.+/40,0+/(G)IVE X AXIS END VALUE*E 








2 


LO 


0+/C23*£ 








3 


EP 


» 0+/2»+/40. 0+/+/99 + /*E 






t 


4 


AA 


(8+/) AA*E 






[ 


5 


FN 


FCALC+/5*E 






\ 


6 


8R 


SETKE+/C23+/G+/0*E 






f 

' O . . - - 


ERJ.C 



I' 



7 r [\* 


SET + /XE-':^E 










1 OT 


* 0+/2^+/40» 0 + /(G) 1 VE (Y )AXIS START VALUE 




2 LD 


0+/C23*E 




3 EP 


• 0 + /2t+/40» 0+/+/99 + /*E 




4 AA 


(8+/ ) AA*E 




b FN 


FC ALC-^/S^E 




6 BR 


SETYS+/C2 3+/G+/0*E 




7 F(\ 


SET+/YS*E 




SETYE^E 






1 f)T 


•0+/2.+/40»0+/(G)IVE (Y )AXIS END VALUE*E 




2 LO 


0+/C23*E 




3 tP 


^ 0 + /2» -t-ZAOf 0+ /+/99 + /'$pE 




4 AA 


(B+/)AA*E 




5 f-N 


FC ALC+/5^E 




6 BR 


SETYE+/C2 3+/G + /0*,: 




7 FN 


SbT+/YE*E 




B BR 


PLGT'<^E 




POINT ^E 






1 PR 


*t 




2 DE 


0+/32*E 




3 DT 


•0+/2»+/40»0+/(E^NTER (X )COOROINATE VALUE*E 




4 FP 


• 0 + /2t+/40 « 0+/+/99-*-/*E 




5 LQ 


0+/C22*£ 




6 LD 


0+/C23*£ 




7 FN 


FCALC + /5*£ 




a BR 


PU INT+/C23+/G+/0*E 




9 LD 


C30+/C28*E 




10 LD 


C 29+/C27*E 




PQ I NT 2 *E 






1 PR 


*E 




2 LD 


0-f/C22^E 




3 LD 


0+/C23*£ 




4 OT 


• 0+/2»+/40.0+/(G )IVE (Y )COORDINATE VALUE*E 




!5 EP 


• 0+/2»+/40» 0 + /+/99^/*E 






FCALC+/5*E 




7 BR 


PO INT2+/C2 3 + /G+/0*E 




8 FN 


AODPNT*E 




9 BR 


PLOT*E 




AX 1S*E 






1 PR 


*E 




2 OE 


0+/32*E 


., ... ■ , ■ 


3 DT 


• 0+/2»+/40» 0+/(0)0 YOU WISH TO DELETE AXES(/*E 




4 EP 


• 0+/2» +/4 0»0-4-/+/3-K/*E 




b CA 


Yt S+/CC*t 




6 FW 


AX! S+/0*E 




7 BR 


PLOT*E 




8 AA 


<6+/l AA*£ 




AXlSx^E 






1 DT 


• 0+/2»+/40.0+/(E)NTER (X )COOROINATE OF lY )AXIS.»:^E 




c L U 






3 EP 


• 0+/2* + /40»0-l-/ + /99 + /*E 




4 AA 


(8+/ ) AA*E 




5 FN 


FCALC+/5*£ 




i 6 BR 


AxIS>c+/C23+/<;+/6*E 





7 LO C30+/C28*E 

H I r> c ^9^-/r?7»f 

- 1_J)J ♦0-»-/2t^/^0.0->/(E)NTgR (Y )CQQRDINATE OF (X )AXfS . 

2 LO 0+/C23*E 

„ 5 fcP t U-t-/2%-*-/^0f 0-t-/-*-/99t/>i^E 

4 AA (a+/)AA*e 

5 Fr4 FCALC-t>/5»E ^ 

6 BR AXlSY + /C23+/G+/05i^E 

7 F N AXIS*E 

8 BR PLOT^E 

. D FL E T E^E ^ 

1 pr'r *t 

2 FN DELETE»E 

3 DE 0+/32*E 

4 P T 30t0-t-/2f 30-t-/AOtO+/COMMAND COMPLETED*E 

5 PAE *E 

6 BR PL OT^E ^ 

TPNSF*E 

1 OF 0^/32»E 

? or rO+/2f+/40,0+/(e)NTER PLOT NAMe«*E 

3 E P » 0-t-/ 2t^/40f 0^-/^/6'f /»E 

4 FN MV + /» •+/BO-f/A*E 

5 WA (8-i-/)WW»E , , • 

6 BR TRNSF*H 

7 CA (B-i-/)CC»E . 

8 FN TRNSFR*E 

9 BR PLOT»E 

fo SN *E 

_^ 5 A 1 O-Il READER NOT READY 

=1^^:^410-12 LAST CARD READ 

^->-4^^lO-2 0 END OF JOB 



